package com.qianying.service;

import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.baomidou.mybatisplus.extension.service.IService;
import com.qianying.comment.CommonResult;
import com.qianying.entity.ExpenseItem;
import java.util.List;

/**
 * 费用项目服务接口
 * 定义费用项目相关的业务方法
 */
public interface ExpenseItemService extends IService<ExpenseItem> {

    /**
     * 分页查询费用项目列表
     * @param page 分页对象
     * @param itemName 费用项目名称（模糊查询）
     * @return 分页结果
     */
    CommonResult<IPage<ExpenseItem>> getPage(Page<ExpenseItem> page, String itemName);

    /**
     * 根据ID查询费用项目详情
     * @param id 主键ID
     * @return 费用项目详情
     */
    CommonResult<ExpenseItem> getById(Long id);

    /**
     * 新增费用项目
     * @param expenseItem 费用项目信息（ID需为空）
     * @return 操作结果
     */
    CommonResult<?> saveItem(ExpenseItem expenseItem);

    /**
     * 更新费用项目
     * @param expenseItem 费用项目信息（需包含ID）
     * @return 操作结果
     */
    CommonResult<?> updateItem(ExpenseItem expenseItem);

    /**
     * 根据ID删除费用项目
     * @param id 主键ID
     * @return 操作结果
     */
    CommonResult<?> removeById(Long id);

    /**
     * 查询所有费用项目（不分页）
     * @return 费用项目列表
     */
    CommonResult<List<ExpenseItem>> getAll();
}
